AS
Section: User Commands (1)
Updated: 20 March 1986
Index
Return to Main Contents
NAME
as - Sun-1, Sun-2 and Sun-3 assembler
SYNOPSIS
as
[
-d2
]
[
-e
]
[
-h
]
[
-j
]
[
-J
]
[
-L
]
[
-mc68010
]
[
-mc68020
]
[
-o
objfile
]
[
-O
]
[
-R
]
filename
DESCRIPTION
as translates assembly code in the named filename
into executable object code in the specified
objfile.
All undefined symbols in the assembly are treated as global.
The output of the assembly is left in the file objfile.
OPTIONS
- -d2
-
Specifies that instruction offsets involving forward or external references
and having sizes unspecified in the assembly language are two bytes long. The
default is four bytes. See also the
-j
option.
- -e
-
Allows control sections to begin on any two-byte boundary,
rather than only four-byte boundaries.
- -h
-
Suppress span-dependent instruction calculations and force all branches to be of
medium length, but all calls to take the most general form.
This is used when assembly must be minimized, while program size and
run-time are unimportant.
This option results in a smaller and faster program than that produced by the
-J
option, but some very large programs may not be able to use it because of the
limits of the medium-length branches.
- -j
-
Use short (pc-relative) branches to resolve jump's and jsr's to externals.
This is for compact programs which cannot use the
-d2
flag because of large program relocation.
- -J
-
Suppress span-dependent instruction calculations and force all branches
and calls to take the most general form.
This is used when assembly time must be minimized,
but program size and run time are not important.
- -L
-
Save defined labels beginning with an `L', which are normally discarded
to save space in the resultant symbol table.
The compilers generate such temporary labels.
- -mc68010
-
Accept only MC68010 instructions and addressing modes, and put
the MC68010 machine-type tag in the object file.
This is the default on Sun-2's.
- -mc68020
-
Accept the full MC68020, MC68881 and the Sun FPA instruction sets
and addressing
modes, and put the MC68020 machine-type tag in the object file.
This is the default on Sun 3's.
- -o
-
The next argument is taken as the name of the object file to be produced.
If the
-o
flag isn't used, the objfile is named
a.out.
- -O
-
Perform span-dependent instruction resolution over entire files
rather than just over individual procedures.
- -R
-
Make initialized data segments read-only by concatenating
them to the text segments.
This eliminates the need to run editor scripts on assembly
code to make initialized data read-only and shared.
FILES
- /tmp/as*
-
default temporary file
SEE ALSO
ld(1),
nm(1),
adb(1),
dbx(1),
a.out(5)
Assembly Language Reference Manual
BUGS
The Pascal compiler, pc, qualifies a nested procedure name by
chaining the names of the enclosing procedures. This sometimes results in
names long enough to abort the assembler, which
currently limits identifiers to 512 characters.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- FILES
-
- SEE ALSO
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 22:49:39 GMT, December 11, 2024